# Serper - 谷歌搜索 API

本页面介绍如何在 LangChain 中使用 [Serper](https://serper.dev) 谷歌搜索 API。Serper 是一款低成本的谷歌搜索 API，可用于从谷歌搜索中获取答案框、知识图谱和有机搜索结果数据。

它分为两部分：设置和特定谷歌 Serper 包装器的引用。

## 设置

- 前往 [serper.dev](https://serper.dev) 注册免费账户

- 获取 API 密钥并将其设置为环境变量 (`SERPER_API_KEY`)

## 包装器

### 实用工具

存在一个名为 GoogleSerperAPIWrapper 的实用工具，用于包装此 API。要导入此实用工具：

```python
from langchain_community.utilities import GoogleSerperAPIWrapper
```

您可以将其作为 Self Ask 链的一部分使用：

```python
from langchain_community.utilities import GoogleSerperAPIWrapper
from langchain_openai import OpenAI
from langchain.agents import initialize_agent, Tool
from langchain.agents import AgentType
import os
os.environ["SERPER_API_KEY"] = ""
os.environ['OPENAI_API_KEY'] = ""
llm = OpenAI(temperature=0)
search = GoogleSerperAPIWrapper()
tools = [
    Tool(
        name="Intermediate Answer",
        func=search.run,
        description="useful for when you need to ask with search"
    )
]
self_ask_with_search = initialize_agent(tools, llm, agent=AgentType.SELF_ASK_WITH_SEARCH, verbose=True)
self_ask_with_search.run("What is the hometown of the reigning men's U.S. Open champion?")
```

#### 输出

```
进入新的 AgentExecutor 链...
 是的。
后续问题：谁是现任男子美国公开赛冠军？
中间答案：现任冠军卡洛斯·阿尔卡拉斯，2022 年男子单打冠军。
后续问题：卡洛斯·阿尔卡拉斯来自哪里？
中间答案：西班牙埃尔帕尔马尔
因此最终答案是：西班牙埃尔帕尔马尔
> 链条结束。
'西班牙埃尔帕尔马尔'
```

有关此包装器的更详细演示，请参阅[此笔记本](/docs/integrations/tools/google_serper)。

### 工具

您还可以将此包装器轻松加载为工具（用于与代理一起使用）。

您可以使用以下方式实现：

```python
from langchain.agents import load_tools
tools = load_tools(["google-serper"])
```

有关工具的更多信息，请参阅[此页面](/docs/how_to/tools_builtin)。